home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / hobby / gim_308.zip / GIM17.DOC < prev    next >
Text File  |  1994-11-02  |  15KB  |  315 lines

  1.           CHAPTER 17     ADVANCED TECHNIQUES
  2.  
  3.           This chapter describes some tips and techniques which will
  4.           optimize GIM's performance.  They are presented in no
  5.           particular order.
  6.  
  7.  
  8. EMS MEMORY...
  9.  
  10.           GIM is designed to operate in a minimal memory configuration.
  11.           That is, it is designed to run on the earliest PC with 512KB
  12.           of memory available.
  13.  
  14.           However, it runs better and faster if EMS memory is available.
  15.  
  16.           EMS memory is memory above the 1MB boundary, primarily
  17.           available on 386 and higher machines, although 286's can be
  18.           configured to provide EMS services.  If your PC comes with
  19.           more than 1MB of memory, check to be sure that some Expanded
  20.           Memory Manager (such as Microsoft's EMM386.SYS) is installed
  21.           in your CONFIG.SYS file.  If you are running GIM under
  22.           Windows, edit your GIM.PIF file to make sure that EMS memory
  23.           is made available.  See your DOS or Windows manual for more
  24.           details.
  25.  
  26.           The more EMS memory you can make available, the better.
  27.  
  28.           For one thing, GIM loads a large portion of itself into EMS
  29.           memory, if available, for faster execution.  (For DOS experts:
  30.           GIM3.OVR is the GIM overlay; this overlay is loaded into EMS
  31.           memory if available.)  If EMS memory is not available, this
  32.           overlay is read from disk.
  33.  
  34.           For another thing, GIM provides its own internal disk cache,
  35.           as a complement to any disk caching your system may already
  36.           provide.  Some of this disk cache is in conventional memory,
  37.           and is therefore available to all systems, with or without
  38.           EMS.  However, a much larger disk cache is available if EMS is
  39.           present, and this disk cache substantially speeds up GIM's
  40.           disk operations.  (If you already have some other disk cache
  41.           in operation, this speed difference is less remarkable.)
  42.  
  43. DISPLAY ADAPTERS...
  44.  
  45.           GIM uses text mode for most of its operations, and so for the
  46.           most part, GIM doesn't care what kind of a display adapter you
  47.           use.
  48.  
  49.           However, when previewing printed forms, GIM uses graphics
  50.           mode, and so some comments are appropriate about the display
  51.           adapter on your system.
  52.  
  53.           GIM is designed to recognize most of the common display
  54.           adapters, such as MDA (monochrome), CGA, EGA, and VGA.
  55.  
  56.           GIM also recognizes the Hercules graphics adapter and VESA
  57.           Super-VGA, but special arrangements need to be made to
  58.           accommodate these situations.
  59.  
  60.           In the case of the Hercules graphics card, you will need to
  61.           run GIM with the word "HERC" on the command line.  That is,
  62.           instead of starting GIM by typing "GIM", you need to start GIM
  63.           by typing "GIM HERC".
  64.  
  65.           For VESA Super-VGA, a couple of items are required.  First of
  66.           all, the file VESA16.BGI, which should have been included with
  67.           your GIM software, must be in the directory from which you run
  68.           GIM.  Additionally, your graphics card must be configured to
  69.           recognize VESA modes.  Some graphics hardware recognizes these
  70.           by default; others require that you load a VESA graphics
  71.           device driver in memory.  If your monitor supports Super-VGA,
  72.           chances are that it supports the VESA extensions; check the
  73.           documentation that came with your monitor for details.  And
  74.           finally, it is necessary to include the keyword "VESA" on the
  75.           GIM command line.  That is, instead of starting GIM by typing
  76.           "GIM", you need to start GIM by typing "GIM VESA".
  77.  
  78.           Either the "HERC" or "VESA" keyword can be included in the
  79.           value of the "GIM" environment variable.  You may want to set
  80.           this value in your autoexec.bat file.
  81.  
  82.           As a side note, depending on the display adapter you're using,
  83.           GIM can support 43 or 50 line mode.  See Chapter 6, entitled
  84.           "The Setup Area", for details.
  85.  
  86. NOVICE/EXPERT MODE...
  87.  
  88.           GIM provides experienced GIM users with a feature that makes a
  89.           little more screen space available, if desired, by sacrificing
  90.           most of the space devoted to the menu bars.
  91.  
  92.           This feature is called the "Novice Mode / Expert Mode Toggle",
  93.           and it is activated by pressing control-F10 from anywhere.
  94.           When you do so, GIM will ask you to enter an "N" for "novice"
  95.           or an "E" for "expert" and will then shift into the requested
  96.           mode.
  97.  
  98.           What do you gain in expert mode?  In expert mode, the menu bar
  99.           is confined to the very top row, freeing up two rows for the
  100.           rest of the display.  All Areas use this extra room to expand
  101.           their displays.  For example, the Family Area makes room to
  102.           show two extra children in expert mode than in normal mode.
  103.  
  104.           What do you sacrifice in expert mode?  Among other things, you
  105.           lose the title information at the very top left of the screen,
  106.           and you lose the "For help, press F9" message at the bottom of
  107.           the screen at startup.  But above all, the principal thing you
  108.           sacrifice is the longer descriptions for the function keys
  109.           that are available on the menu bar in normal mode, because the
  110.           menu bar is highly condensed.  For example, "View/Edit Person"
  111.           becomes "Persn", and "Utilities" becomes "Utils".  Of course,
  112.           that's why this mode is designed for experts -- we assume that
  113.           you already know what the function keys do when you're in this
  114.           mode, and so the abbreviations are just meant to be gentle
  115.           reminders.
  116.  
  117.           Note:  like 43/50 line mode, expert mode has no effect in the
  118.           Folder Area.
  119.  
  120. COMMAND LINE PARAMETERS...
  121.  
  122.           There are a number of options that can be specified from the
  123.           command line.  These are not necessary under most conditions,
  124.           but are provided for certain out of the ordinary situations.
  125.           They are:
  126.  
  127.                BIOS -- Use BIOS rather than direct video for writing to
  128.                the display.  BIOS calls are slower, but sometimes
  129.                necessary, such as in the case where DESQview requires
  130.                them to prevent bleeding.
  131.  
  132.                DEBUG -- Creates a GIMDEBUG.OUT file in the current
  133.                directory.  Generally this is an uninteresting file, but
  134.                is used in certain situations to help the GIM Authors
  135.                resolve problem reports.  See Addendum J of chapter 11 of
  136.                this documentation for an example.
  137.  
  138.                GIM= -- Specify where program overlay (*.OVR) and
  139.                auxiliary (*.AUX) files are located.  We don't use this
  140.                very often, if at all.  We find it easier just to leave
  141.                the *.OVR and *.AUX files together with the *.EXE files,
  142.                and run the program from there.
  143.  
  144.                HERC -- Specify use with a Hercules display adapter.  See
  145.                "Display Adapters" above for details about this option.
  146.  
  147.                NOEMS -- Disable automatic EMS use.  There's no simpler
  148.                way to do this, but we're not sure why you would want to.
  149.  
  150.                NOMOUSE -- Disable automatic mouse detection and use.
  151.                Should you wish to do this, it's easier to disable the
  152.                mouse from the Setup Area than to use this command line
  153.                switch; see chapter 6 of this documentation for details.
  154.  
  155.                STARTUP -- Fool GIM into believing that you haven't set
  156.                your colors yet, and have it ask you to specify them when
  157.                the program starts up.  An easier way to do this is to
  158.                press shift-F7 from the Setup Area; see chapter 6 of this
  159.                documentation for details.  An even easier way to do the
  160.                same thing is to erase the GIMCOL.AUX file from your GIM
  161.                directory.
  162.  
  163.                VESA -- Enable automatic VESA graphics use.  As described
  164.                above, you will need to have the VESA16.BGI file in your
  165.                GIM directory, and your graphics adapter must handle VESA
  166.                graphics properly, in order for this switch to work.
  167.  
  168.                Earlier versions of this program assumed VESA, and
  169.                required the NOVESA switch to turn VESA detection off;
  170.                this has changed, because the other method resulted in
  171.                too many cases of people with non-standard graphics
  172.                adapters calling us to report that GIM wouldn't work on
  173.                their computer.
  174.  
  175. ENVIRONMENT VARIABLES...
  176.  
  177.           GIM looks at the presence of a number of environment
  178.           variables.  (See your DOS manual for more information about
  179.           environment variables.)  In general, these serve the same
  180.           purpose as the command line switches described above.  They
  181.           are:
  182.  
  183.                BIOS
  184.                DEBUG
  185.                HERC
  186.                NOEMS
  187.                NOMOUSE
  188.                STARTUP
  189.                VESA
  190.                     If any of these is present in the environment, it
  191.                     does the same thing that the corresponding command
  192.                     line switch does, as described above.  The value of
  193.                     these environment variables is irrelevant; they can
  194.                     be set to anything at all and have the same effect.
  195.  
  196.                GIM
  197.                     If this is present in the environment, it should
  198.                     contain a space-separated list of the options above
  199.                     -- BIOS, DEBUG, and so on.  Those values, when
  200.                     present here, have the same effect as if they are
  201.                     specified elsewhere.
  202.  
  203.                GIMPATH
  204.                     If this is present in the environment, its value is
  205.                     interpreted as the location of program overlay and
  206.                     auxiliary files, as described above.
  207.  
  208.                GIMTINY
  209.                GIMSMALL
  210.                     If either if these is present, they reduce the
  211.                     amount of memory available to the heap, making more
  212.                     memory available to the conventional memory cache
  213.                     and the overlay.  (See "Reading the Setup Area
  214.                     Display" in chapter 6 of this documentation for more
  215.                     information.)  GIMTINY is reduces the heap more than
  216.                     GIMSMALL does.  Neither of these is recommended,
  217.                     except as a last resort.
  218.  
  219. MULTITASKING...
  220.  
  221.           If you are using a multitasking system, such as Quarterdeck's
  222.           DESQview, Microsoft Windows, or OS/2, you may be tempted to
  223.           run two or more instances of GIM simultaneously.
  224.  
  225.           If you do so, you do so at your own risk.  We do not recommend
  226.           it, although we mention cautiously that we do this ourselves.
  227.           However, we can get away with it because we wrote the program
  228.           and we know what pitfalls to avoid.
  229.  
  230.           Below are some suggested pitfalls to avoid, but we make no
  231.           guarantees about this being an exhaustive list, and we DO NOT
  232.           accept any liability for damage to your data that results from
  233.           running multiple instances of GIM.  Like we say, do this at
  234.           your own risk.
  235.  
  236.           Do NOT open the same folder in two different windows.  (If you
  237.           load SHARE.EXE in your AUTOEXEC.BAT file, GIM won't let you do
  238.           this, even if you try.  See your DOS manual for details on
  239.           SHARE.EXE.)
  240.  
  241.           Do NOT do the same kinds of things in two different windows.
  242.           For example, don't try to do a GFE import from two windows at
  243.           once.  In particular, GFE, forms printing, grafting, and GIM
  244.           LISTS should all be avoided in two windows at once.
  245.  
  246.           Avoid closing two folders at the same time.  Avoid exiting GIM
  247.           in both windows at the same time.
  248.  
  249.           (Oh, and a word about local area networks (LANs):  we don't
  250.           know for sure how GIM will perform when multitasked in a LAN.
  251.           Be extremely careful and proceed at your own risk.)
  252.  
  253. MICROSOFT WINDOWS...
  254.  
  255.           We have had no problems running GIM from a DOS window from
  256.           within Microsoft Windows.  If you have any difficulty with
  257.           this, please bring any problems to our attention.
  258.  
  259.           Will there be a version of GIM that runs as a Windows
  260.           application?  We agree that there should be, and there
  261.           probably will be someday.  Many of the things that have made
  262.           GIM somewhat difficult to design -- such as printer support,
  263.           Help windows, 43/50 line screen support, and mouse support,
  264.           among others -- would evaporate if GIM were a Windows
  265.           application.
  266.  
  267.           Note that GIM.PIF, GIM.ICO, and GIM.BMP files are included
  268.           with the GIM distribution for use with Microsoft Windows.
  269.  
  270. QUARTERDECK'S DESQVIEW...
  271.  
  272.           Here also, we have had no difficulty running GIM in a DESQview
  273.           window, and if you encounter any difficulties, please bring
  274.           them to our attention.
  275.  
  276.           If GIM bleeds through your DESQview window with DESQview 386,
  277.           set "Virtualize text/graphics" to T and "Writes text directly
  278.           to screen" to Y.  If this occurs with DESQview, that is, not
  279.           DESQview 386, add the word "BIOS" to the program's parameters.
  280.  
  281.           Recommended DESQview DVP settings:
  282.  
  283.           If you are using GIM in 43/50 line mode, remember to set the
  284.           "Window Position Maximum Height" to 43 or 50 with DESQview's
  285.           "Change a Program" option.  However, if you're NOT using 43/50
  286.           line mode, be sure that the "Window Position Maximum Height"
  287.           is set to 25, otherwise strange things will happen to most of
  288.           GIM's displays!
  289.  
  290.           Memory size (in K):  512
  291.  
  292.           Maximum Program Memory Size (in K):  800
  293.  
  294.           Maximum Expanded Memory Size (in K):  (leave blank)
  295.  
  296.           Uses its own colors:  Y.
  297.  
  298. 4DOS...
  299.  
  300.           GIM is perfectly compatible with 4DOS.  GIM has been
  301.           thoroughly tested with both the DOS and 4DOS command
  302.           processors, and no problems have been encountered.
  303.  
  304. INSIDE THE SOFTWARE DESIGN OF GIM...
  305.  
  306.           GIM was written in, and compiled by, Borland Pascal 7.0.
  307.  
  308.           If you're a programmer and would like to write applications
  309.           that interact with GIM's folder and auxiliary data files,
  310.           please contact us for technical notes about the file formats
  311.           and data structures involved.  We may choose to withhold
  312.           certain pieces of proprietary information, but we'll be happy
  313.           to provide you with the information you need to build your own
  314.           GIM applications.
  315.